Conectar Cloudflare
Connect Cloudflare usage-based charges with a Billing Read account token and see credits and unpaid debt.
Conectar Cloudflare
Bring Cloudflare's usage-based charges (Workers, R2, D1, Workers AI and more) into CostGlass with a read-only account API token.
- Crea un token API de cuenta con un único permiso, Cuenta → Facturación → Leer, y lo pega con su ID de cuenta de 32 caracteres.
- CostGlass reads Cloudflare's Billable Usage API, which is in alpha. It covers usage-based charges on self-serve (pay-as-you-go) accounts only.
- Los planes de tarifa fija, como Pro o Business, y las cuentas de contrato Enterprise, no están en ese feed, por lo que una cuenta conectada puede legítimamente no mostrar ningún gasto.
- CostGlass lo dice cuando no vuelve nada. Nunca inventa una figura.
- La tarjeta también puede mostrar su crédito restante de Cloudflare y cualquier factura impaga.
- Puedes conectar varias cuentas de Cloudflare. Cada cuenta se puede conectar una vez.
Qué está cubierto y qué no
Tenga esto claro antes de conectarse, porque decide si verá números.
| Facturación de Cloudflare | ¿Se muestra en CostGlass? |
|---|---|
| Cargos basados en el uso en una cuenta de autoservicio (pago por uso): Workers, R2, D1, Workers AI, Vectorize, Images, Stream y similares | Sí |
| Suscripciones a planes de tarifa fija (por ejemplo, un plan Pro o Business) | No. No están en el feed. |
| Cuentas de contrato empresarial | No. No están en el feed. |
| Una cuenta gratuita sin productos basados en el uso | Nada que mostrar. Se conecta e informa que no se encontró ningún uso. |
- Una cuenta de Cloudflare donde puedes crear tokens API de cuenta.
- Su ID de cuenta (ver más abajo).
- Una cuenta de propietario o administrador en CostGlass y espacio en tu plan para otra conexión.
Paso a paso
Qué comprueba CostGlass cuando te conectas
CostGlass asks Cloudflare for the account's billable-usage information. Esa llamada demuestra que el token es válido, tiene Facturación → Sigue leyendo eso cuenta y que el ID de cuenta es correcto. Si algo de eso está mal, verá un mensaje y no se almacenará nada. The token is saved only in CostGlass's encrypted secrets store.
Luego verá uno de dos resultados:
| Resultado | lo que ves | Significado |
|---|---|---|
| Uso encontrado | A "Cloudflare Successfully Connected!" panel, then the card with a record count. | Se leyeron los cargos basados en el uso. |
| No se encontró ningún uso | A warning panel, "Cloudflare connected, no usage found yet", with Cloudflare's own answer. | The token is valid, but Cloudflare returned no usage-based billing. The account stays connected and is picked up automatically once Cloudflare reports usage. |
Sobre la bandera “cubierta”
Cloudflare's information call includes a field called covered, which its documentation does not define. A non-Enterprise account has been seen to report covered=false and still have a valid token. Por esa razón CostGlass nunca lo trata como un sí o un no. Siempre intenta leer el uso y decide en función de lo que regresa. El mensaje "no se encontró ningún uso" cita lo que dijo Cloudflare (por ejemplo, "cubierto=falso, 0 suscripciones") y enumera los posible motivos, sin afirmar cuál se aplica a usted.
¿Qué datos verás?
- Costo por producto de Cloudflare, dividido por zona (tu dominio) donde Cloudflare te da uno, para que puedas ver a qué zona pertenece un cargo. En CostGlass la zona aparece como recurso.
- Cifras diarias donde Cloudflare informa los cargos diarios, más los totales mensuales de cada mes calendario completo.
- El mes actual se muestra hasta la fecha. Un total mensual se escribe solo para un mes calendario que los datos obtenidos cubren por completo, por lo que una sincronización parcial no puede sobrescribir un mes completo correcto.
- Una categoría de producto aproximada para cada servicio (por ejemplo, Workers es Computación, R2 es Almacenamiento, D1 es Bases de datos, Workers AI es AI y Machine Learning). This is CostGlass's mapping, not Cloudflare's.
- La primera sincronización revisa hasta 14 de sus períodos de facturación de Cloudflare; Las sincronizaciones posteriores actualizan las tres últimas.
- Lo que realmente se factura se utiliza como coste. Un producto que no factura nada no almacena nada.
Cloudflare's billing period starts on an anchor day of your own, but CostGlass reports in calendar months to match every other cloud, so a figure for a month may be built from parts of two Cloudflare billing periods. Los costos aparecen en Explorador de costos y Informes junto a tus otras nubes.
Insignias de créditos y deudas impagas
Cada sincronización también lee dos pequeños datos de la cuenta, por lo que la tarjeta Cloudflare puede mostrar señales financieras junto con el gasto. Son el mejor esfuerzo: si uno falla, la sincronización aún se realiza correctamente y se muestran incluso para una cuenta que aún no está en uso.
- Insignia de crédito
- Se muestra cuando la cuenta tiene crédito. It reads like "Credit US$50.00 of US$100.00 · 50% used · 276 days left". Pase el cursor sobre las fechas en las que el crédito es válido y, cuando Cloudflare lo proporcione, la fecha en la que se prevé que se agote.
- Insignia no pagada
- Se muestra cuando Cloudflare informa facturas impagas. It reads like "Unpaid US$123.45 · status". Coloca el cursor para ver cuántas facturas y el estado que proporciona Cloudflare.
Sincronizando, varias cuentas, desconectando
- CostGlass se sincroniza cada seis horas. Haga clic en Sincronizar ahora en la pestaña Cloudflare para sincronizar todas sus cuentas de Cloudflare conectadas ahora.
- Cada cuenta aparece como su propia tarjeta. Una cuenta de Cloudflare solo se puede conectar una vez a su organización, pero puede conectar varias cuentas diferentes.
- Desconectar le pide que confirme, detiene la sincronización y elimina el token almacenado. Los datos de costos ya recopilados se conservan.